#%RAML 1.0 ResourceType
    description: Entity representing a <<resourcePathName|!singularize>>
    is: [validate,language]

    post:
      responses:
        201:
          description: "Returns a newly created item, with server-controlled fields like 'id' populated"
          body:
            application/json:
              type: <<schema>>
              example:
                strict: false
                value: <<exampleItem>>
        400:
          description: "Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response."
          body:
            text/plain:
              example: |
                "unable to add <<resourcePathName|!singularize>> -- malformed JSON at 13:3"
        401:
          description: "Not authorized to perform requested action"
          body:
            text/plain:
              example: "unable to create <<resourcePathName>> -- unauthorized"
        404:
          description: "Item with a given ID not foun"
          body:
            text/plain:
              example: "unable to create <<resourcePathName>> -- unauthorized"
        500:
          description: "Internal server error, e.g. due to misconfiguration"
          body:
            text/plain:
              example: "Internal server error, contact administrator"

